Un générateur de site statique qui casse des briques. VenC est tellement rapide qu'il enfreint le principe de causalité et produit de l'énergie surunitaire ! |
Pour vous faciliter la vie, VenC est livré avec au moins un thème qui peut vous servir de base pour créer le vôtre. C'est également idéal pour voir comment
sont mis en pratique certains concepts de VenC. Quand vous installez VenC, ce thème est placé dans : $(venc -pp)/themes/concrete
Ce thème s'appelle concrete
. Vous pouvez donc l'utiliser en générant votre site avec :
venc -xb concrete
Ou en l'installant localement dans votre projet avec la commande suivante :
venc -it concrete
L'avantage de cette dernière méthode étant qu'elle vous permet de modifier le thème en profondeur.
Ce thème peut être adapté à vos besoins sans le modifier directement à l'aide d'une série de variables à définir dans votre fichier de configuration principal :
Les catégories sont gérées avec GetBlogCategoriesTreeFromBranches
et
GetFlattenedBlogCategoriesFromBranches
, en conséquence
le thème utilise une métadonnée obligatoire nommée taxonomy
contenant une liste de sous-catégories à afficher.
disable_blog_hashtags
: il s'agit d'un booléen
pour désactiver l'affichage du nuage de catégories sous la forme de hashtag.disable_categories_tree
: il s'agit d'un booléen
pour désactiver l'affichage des catégories sous la forme d'arbre hiérarchique.disable_entry_hashtags
: il s'agit d'un booléen
pour désactiver l'affichage du nuage de catégories des publications.disable_infinite_scroll
: il s'agit d'un booléen
permettant de désactiver le script JS de défilement infini.custom_scripts
: il s'agit d'une liste contenant les noms des fichiers de scripts que vous souhaitez inclure. Ceux-là doivent être placés dans le répertoire extra
de votre projet.custom_styles
: il s'agit d'une liste contenant les noms des fichiers de feuilles de style que vous souhaitez inclure. Ceux-là doivent être placés dans le répertoire extra
de votre projet.disable_chapters
: il s'agit d'un booléen
pour désactiver l'affichage de la liste des chapitres.disable_archives
: il s'agit d'un booléen
pour désactiver l'affichage de la liste des archives.force_entry_content
: il s'agit d'un booléen
pour forcer l'affichage du contenu des publications dans les fils de publications.loading_image
: il s'agit du nom de fichier d'une éventuelle image de chargement à afficher quand le défilement infini est activé.include_in_footer
: il s'agit du nom de fichier d'un éventuel pied de page HTML à inclure.disable_rss_feed
: empêche VenC de générer un flux RSS. Ce champ est un booléen, fixé à False
par défaut.disable_atom_feed
: empêche VenC de générer un flux Atom. Ce champ est un booléen, fixé à False
par défaut.